Skip to content

new blog for parallel chunk uploads#2966

Merged
adityaoberai merged 11 commits into
mainfrom
feat-fatser-uploads
May 21, 2026
Merged

new blog for parallel chunk uploads#2966
adityaoberai merged 11 commits into
mainfrom
feat-fatser-uploads

Conversation

@eldadfux
Copy link
Copy Markdown
Member

@eldadfux eldadfux commented May 5, 2026

What does this PR do?

(Provide a description of what this PR does.)

Test Plan

(Write your test plan here. If you changed any code, please provide us with clear instructions on how you verified your changes work.)

Related PRs and Issues

(If this PR is related to any other PR or resolves any issue or related to any issue link all related PR and issues here.)

Have you read the Contributing Guidelines on issues?

(Write your answer here.)

@appwrite
Copy link
Copy Markdown

appwrite Bot commented May 5, 2026

Appwrite Website

Project ID: 69d7efb00023389e8d27

Sites (1)
Site Status Logs Preview QR
 website
69d7f2670014e24571ca
Ready Ready View Logs Preview URL QR Code

Website (appwrite/website)

Project ID: 684969cb000a2f6c0a02

Sites (1)
Site Status Logs Preview QR
 website
68496a17000f03d62013
Queued Queued View Logs Preview URL QR Code


Tip

Appwrite has crossed the 50K GitHub stars milestone with hundreds of active contributors

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented May 5, 2026

Greptile Summary

This PR adds a new blog post announcing parallel chunk uploads in Appwrite SDKs, a matching changelog entry, and accompanying documentation updates across the storage reference, REST API, and CLI docs.

  • Blog post (faster-storage-uploads-parallel-chunks): covers the feature motivation, per-SDK code examples for all supported languages, benchmark table (internally consistent — concurrency of 1 for 2-chunk files, scaling to 8 for large files), and valid internal links.
  • Documentation updates: storage.md, rest/+page.markdoc, and buckets/+page.markdoc each receive a short, accurate note about parallel chunk sending; the new deep-link to /docs/products/storage/upload-download#large-files resolves correctly.
  • Changelog entry: now correctly named 2026-05-21-1.markdoc with a matching date: 2026-05-21 frontmatter, resolving the previously noted filename/date mismatch.

Confidence Score: 5/5

This is a documentation and blog post PR with no functional code changes; it is safe to merge.

All changes are content-only (markdoc, markdown, a binary image, and an auto-generated JSON file). The blog post links and documentation deep-links all resolve, benchmark numbers are internally consistent, and the changelog filename now matches its frontmatter date. The previously flagged issues (cache key mismatch, github-stars formatting) are already captured in earlier review threads.

No files require special attention beyond issues already discussed in previous review threads.

Important Files Changed

Filename Overview
src/routes/blog/post/faster-storage-uploads-parallel-chunks/+page.markdoc New blog post announcing parallel chunk uploads; content is accurate, code examples cover all SDK languages, benchmark table is internally consistent, and all internal links resolve correctly.
src/routes/changelog/(entries)/2026-05-21-1.markdoc New changelog entry; filename (2026-05-21-1.markdoc) now matches the frontmatter date (2026-05-21), and the blog link resolves to the new post.
src/routes/docs/apis/rest/+page.markdoc Chunked-upload section updated to mention parallel concurrency and REST-level guidance; the new link to /docs/products/storage/upload-download#large-files resolves correctly.
src/routes/docs/references/[version]/[platform]/[service]/descriptions/storage.md One-sentence addition noting parallel chunking capability; accurate and consistent with other doc updates.
src/routes/docs/tooling/command-line/buckets/+page.markdoc create-file description extended with a note about SDK parallel chunk sending; change is accurate and minimal.
.optimize-cache.json Cache entry added for cover.png, but the actual image shipped is cover.avif — key mismatch will cause a permanent cache miss or un-optimized image.
src/lib/generated/github-stars.json Auto-generated file with updated star count; indentation changed from 4 to 2 spaces and trailing newline removed, which can cause noisy diffs.
static/images/blog/faster-storage-uploads-parallel-chunks/cover.avif Binary cover image added; filename is .avif as referenced in the blog post and changelog frontmatter.

Reviews (10): Last reviewed commit: "Merge branch 'main' into feat-fatser-upl..." | Re-trigger Greptile

Comment thread src/lib/generated/github-stars.json Outdated
Replace projected speedups with Node SDK benchmark table (1.07x at 10 MB up
to 7.10x at 1.28 GB). Drop the runtime hedge paragraph since PR #1498 ships
parallel uploads in every SDK. Expand multicode block from 4 to 15 samples
covering all client and server SDKs.
Comment thread .optimize-cache.json
"static/images/blog/everything-new-with-appwrite-1.5/1.5-recap.png": "1d3c646f6902757152d98861630c1952631a54f222af7f8476f53f4d0d3c59f2",
"static/images/blog/everything-new-with-appwrite-1.5/messaging-console.png": "769b7df74c9107a5ccacfe87722293adbfbd91ab702c79b03838c2368e9971ac",
"static/images/blog/examples-of-vibe-coding/cover.png": "745d0e65c7981fe852b2e1797c3163cd4e4c147227b906cf305019137cb4624f",
"static/images/blog/faster-storage-uploads-parallel-chunks/cover.png": "4565a9b19b4cafad3ed9ca3f2d4c6e4437379c5d10de6bad64dc1fb85590e49b",
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 The cache entry records cover.png, but the actual image added in this PR is cover.avif. This means the optimize-cache will never match the real file on disk, so the image either goes un-optimized or causes a spurious cache miss on every build.

Suggested change
"static/images/blog/faster-storage-uploads-parallel-chunks/cover.png": "4565a9b19b4cafad3ed9ca3f2d4c6e4437379c5d10de6bad64dc1fb85590e49b",
"static/images/blog/faster-storage-uploads-parallel-chunks/cover.avif": "4565a9b19b4cafad3ed9ca3f2d4c6e4437379c5d10de6bad64dc1fb85590e49b",

@atharvadeosthale
Copy link
Copy Markdown
Member

@copilot change the announcement blog date in this PR to 18th May 2026, and same for changelog. DO NOT make any other changes.

Agent-Logs-Url: https://github.com/appwrite/website/sessions/bdb7e5d0-3594-4101-906e-6497dc7c73b5

Co-authored-by: atharvadeosthale <11805367+atharvadeosthale@users.noreply.github.com>
Copy link
Copy Markdown
Contributor

Copilot AI commented May 18, 2026

@copilot change the announcement blog date in this PR to 18th May 2026, and same for changelog. DO NOT make any other changes.

Updated both the announcement blog date and changelog date to 18th May 2026 in commit 4a2430a.

Comment on lines +1 to +6
---
layout: changelog
title: "Up to 7x faster Appwrite Storage uploads with parallel chunks"
description: Appwrite SDKs now upload Storage chunks in parallel on runtimes with native concurrency. Our Node SDK benchmarks show up to 7.10x faster uploads on large files, with no API changes for developers.
date: 2026-05-18
cover: /images/blog/faster-storage-uploads-parallel-chunks/cover.avif
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Filename/date mismatch

The file is named 2026-05-15-1.markdoc but its frontmatter declares date: 2026-05-18. Looking at the existing entry pattern (e.g. 2026-05-15.markdoc has date: 2026-05-15), the filename is used as the sort key for rendering the changelog. This entry will be sorted and displayed as May 15, three days before its stated publication date, causing it to appear out of order relative to other May 18 content.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot address this, change the file name to the date in frontmatter

Agent-Logs-Url: https://github.com/appwrite/website/sessions/d13793c4-edbc-4544-8068-53d3d8808d0e

Co-authored-by: atharvadeosthale <11805367+atharvadeosthale@users.noreply.github.com>
@atharvadeosthale
Copy link
Copy Markdown
Member

@copilot change the date for blog and changelog for parallel chunking announcement to 21st May 2026. remember to change the changelog file name too.

Agent-Logs-Url: https://github.com/appwrite/website/sessions/202eb12b-fba5-4ccd-9458-c4e277f8be1d

Co-authored-by: atharvadeosthale <11805367+atharvadeosthale@users.noreply.github.com>
Copy link
Copy Markdown
Contributor

Copilot AI commented May 21, 2026

@copilot change the date for blog and changelog for parallel chunking announcement to 21st May 2026. remember to change the changelog file name too.

Updated in b6ed9ab: both the blog and changelog dates are now 2026-05-21, and the changelog file was renamed to 2026-05-21-1.markdoc. This is a content/date-only change, so there isn’t a distinct UI screenshot to attach.

@adityaoberai adityaoberai merged commit 6e3d406 into main May 21, 2026
7 checks passed
@adityaoberai adityaoberai deleted the feat-fatser-uploads branch May 21, 2026 19:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants